home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 6 / QRZ Ham Radio Callsign Database - Volume 6.iso / mac / files / amiga / loger303.lzh / log.doc < prev    next >
Text File  |  1993-03-25  |  56KB  |  1,178 lines
  1. #1zz
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                    The Amiga Contest Logging Programs V3.03
  8.  
  9.                    Copyright 1992,1993 by Peter Hardie VE5VA
  10.  
  11.                        General Instructions (25-Mar-93) 
  12.  
  13.   1. Introduction
  14.  
  15.      These instructions  describe the  features that apply to all versions of
  16.      the contest logging programs (currently: CQWW,  WPX, CARF,  FD, SS, ARLX
  17.      and QRP).
  18.  
  19.      Instructions specific  to each  contest program haven't been written yet
  20.      but if you're familiar with the exchange in a contest then you shouldn't
  21.      have trouble figuring out how to talk to them. 
  22.  
  23.      You use  these programs  AT YOUR  OWN RISK  on an  AS-IS basis. I do NOT
  24.      guarantee that these programs will  perform  as  described,  nor  as you
  25.      expect them  to, and  I accept  no liability  whatever if these programs
  26.      lose information, score incorrectly or in any other way fail  to perform
  27.      correctly. 
  28.  
  29.      You MUST read Chapter 7.
  30.  
  31.      If you  have used  these programs  before, then  at least read Chapter 6
  32.      "KNOWN BUGS and SHORTCOMINGS" to see if any  major bugs  have been fixed
  33.      or found.  Also look  at the file "changes" which documents changes made
  34.      to the programs as I go along.
  35.  
  36.      In order to use the programs you MUST be able  to use  a text  editor to
  37.      set up some of the files that control the programs and at the moment the
  38.      programs can only be  started from  the shell.  I hope  to add workbench
  39.      support some time or other. 
  40.  
  41.      1.1 For the impatient
  42.  
  43.      Those of  you who  don't read past the introduction of any documentation
  44.      will find that as long as you use the same directory structure as exists
  45.      on the disk, then you won't need to do much in the way of setting up the
  46.      programs other  than to  put a  setenv command  in your startup-sequence
  47.      which describes  your local timezone so that the program can compute UTC
  48.      for proper timestamping of  your  log  entries.  You  must  also  do the
  49.      following:
  50.  
  51.      - If you  are going  to use  computer control of your rig you must start
  52.           up the  appropriate driver  program before  you start  up a contest
  53.           program (currently  this is  fairly easy because I only support the
  54.           IC735). 
  55.  
  56.      - If you use the AREXX functions  (PacketCluster) then  you must  have a
  57.           copy of  rexxhost.library in  your LIBS:  directory. The library is
  58.           supplied with this distribution. BUT there is currently  NO program
  59.           to send  the packetcluster  information to the logger programs. You
  60.           can write one yourself. I hope to have one ready soon. z
  61.  
  62.  
  63.  
  64.  
  65.      - You must set up a default file for  each program  you wish  to run. In
  66.           addition,  you  can  put  some  of the common default commands in a
  67.           global.defaults file in the lists directory.
  68.  
  69.   2. Hardware Requirements.
  70.  
  71.      2.1 Computer
  72.  
  73.      The logging programs should run on any Amiga which has at least  512K of
  74.      memory.  A  hard  drive  is  preferable  for  storing the log during the
  75.      contest as the I/O  is faster,  but it  is not  essential. However, when
  76.      running the  program, your  log file  MUST be  on disk.  If you tell the
  77.      computer to store the log in ram, a power failure will lose  your entire
  78.      log. The  program has  been tested  on an  A3000 using Kickstart 1.3 and
  79.      2.04 and both work. It has also been partially tested  on an  A1000 with
  80.      2Mb  using  Kickstart  1.3  and  it  also works (although the AREXX port
  81.      hasn't been tested there). 
  82.  
  83.      The memory requirement will be the most critical  for those  of you with
  84.      only 512k.  When allocating the memory for the log, the programs ask for
  85.      it all in one big lump. This  way  you  will  know  before  you  start a
  86.      contest whether  or not you have enough memory. By default, the programs
  87.      ask for enough space to handle 2000 QSOs.  You can  specify a  larger or
  88.      smaller number  of QSOs by using the 'n' command in the default file for
  89.      the specific contest. But  you  must  ensure  that  whatever  number you
  90.      choose, it  will be big enough to handle the whole contest. If you don't
  91.      make the number big enough then  the program  will terminate  as soon as
  92.      the limit  has been  reached. In this case you can increase the QSO size
  93.      by editing the default file and then starting the contest program again.
  94.      The programs  also allocate  smaller chunks of memory for the multiplier
  95.      lists and to do some types of report.
  96.  
  97.      2.2 Audio output
  98.  
  99.      The computer sends an audible beep out of the audio jacks when  an error
  100.      (e.g. a dupe or unrecognized callsign) occurs. The old A1000 monitor has
  101.      the audio built-in so there's nothing  for you  to do  to use  it except
  102.      turn up  the volume.  Some of the newer monitors (e.g. 1950) do not have
  103.      audio output so you must hook up the Amiga's audio output to  a suitable
  104.      amplifier and  speaker. When sending a beep to the monitor, the computer
  105.      also generates a  DisplayBeep()  function  which  causes  the  screen to
  106.      flash. This  is useful  if you wear headphones and won't be able to hear
  107.      the computer.
  108.  
  109.      It takes a noticeable amount of time to transmit the three beeps  to the
  110.      audio device  when a dupe or error occurs and so you have the option, in
  111.      the default file, of turning the  audio off  (if you  use headphones you
  112.      probably won't  hear it  anyway!). The command "a 0" in the default file
  113.      will turn the audio off. 
  114.  
  115.      The hardware described in the remaining sections is all optional.
  116.  
  117.  
  118. z
  119.  
  120.  
  121.  
  122.  
  123.      2.3 Computer controlled radios
  124.  
  125.      The program has  been  tested  with  an  ICOM  IC-735  using  a homebrew
  126.      interface. It  also works  on a FT-767GX using their FIF-232C interface.
  127.      I plan to also have the program understand various other ICOM, Yaesu and
  128.      Kenwood rigs. The diagram for my IC-735 interface, which uses two 2N2222
  129.      transistors is included in a separate file (iface.txt).  If your  rig is
  130.      not supported  yet then send me a detailed spec of the computer commands
  131.      and the interface required and I'll try to add it to the list.
  132.  
  133.      All computer controlled radios use the serial port but some of them need
  134.      more of  the pins  wired up  than others.  The IC-735  requires that the
  135.      following pins be connected:
  136.  
  137.      Pin 2   Tx
  138.      Pin 3   Rx
  139.      Pin 7   Gnd
  140.  
  141.      My interface  also  requires  +12V  to  be  connected  and  some  of the
  142.      commercial interfaces may also need it:
  143.  
  144.      Pin 23 (A1000 only) +12V
  145.      Pin 9  (all others) +12V
  146.  
  147.      If  you  make  up  a  homebrew  interface  you  must  be VERY careful to
  148.      identify the +12V pin  correctly or  you could  blow the  8520 chip. You
  149.      must also  take great  care when  plugging the interface into the serial
  150.      port's DB-25. The port uses a male plug  and if  you use  a DB-25 female
  151.      with a  metal shell, then the shell could short the +12V to ground. This
  152.      blows a fuse in the computer and it costs a lot of money to  replace it.
  153.      Therefore,  whenever  you  plug  in  the serial port interface, TURN THE
  154.      COMPUTER OFF FIRST! The only way  you can  safely plug  in the interface
  155.      without blowing  the fuse  while the computer is switched on is by using
  156.      an all-plastic DB-25. 
  157.  
  158.      Yaesu rigs appear to need the same pins connected as the ICOM.
  159.  
  160.      Kenwood rigs also require:
  161.  
  162.      Pin 4   CTS
  163.      Pin 5   RTS
  164.  
  165.      although I suspect that  my version  of the  program will  not suffer if
  166.      these pins were not connected.  
  167.  
  168.      Some rigs,  notably the Yaesu FT757GX can only receive commands from the
  169.      computer and cannot transmit  responses  at  all.  The  logging programs
  170.      allow for  control of  the radio  from the computer so that provided you
  171.      use only the program to control the rig,  it can  log your  contacts for
  172.      you. But it might be safer to get used to doing without.
  173.  
  174.  
  175.  
  176. z
  177.  
  178.  
  179.  
  180.  
  181.      2.4 Morse code output
  182.  
  183.      WARNING -  as of V3.00 the morse code output has been moved from the RS-
  184.      232 Pin 20 to joystick Pin 9.
  185.      All the contest programs have a  built-in keyer  with ten  memories. The
  186.      keyer speed  and the  content of  the memories can be initially set in a
  187.      configuration file and also  modified on-the-fly  from 10  to 50wpm. The
  188.      morse code  is transmitted out of pin 9 of the second joystick port. PTT
  189.      is output from Pin 5 of the joystick port. You  do not  have to  use the
  190.      PTT output - you can use your rig's VOX to key your rig if you wish. 
  191.    
  192.      The cursor  UP and  DOWN keys can be used to change the keyer's CW speed
  193.      by plus or minus 2wpm each time the key is hit.
  194.  
  195.      2.5 Morse code input
  196.  
  197.      All of the contest programs also provide an electronic morse code keyer.
  198.      The keyer  can emulate  an iambic  paddle with dot and dash memory and a
  199.      choice of either Curtis  A or  B timing.  It will  also emulate  a semi-
  200.      automatic bug  with automatic  dots and  manual dash, or just a straight
  201.      key (which is just the key connected  to  the  dash  side  of  the semi-
  202.      automatic bug).
  203.  
  204.      This  function  is  used  by  connecting your key to the second joystick
  205.      port. The pin connections are:
  206.  
  207.         Pin 8 - Gnd
  208.         Pin 2 - Dot Input
  209.         Pin 4 - Dash Input (or straight key)
  210.  
  211.      This function was provided more as an academic  exercise to  show that I
  212.      could do  it, but  it can  also be  useful if you need to send something
  213.      which is not covered by the content of the ten  memories and  it is more
  214.      convenient to have your paddle connected to the computer instead of your
  215.      keyer.
  216.  
  217.      In the future, I may add code to read what you are transmitting with the
  218.      paddle so that you it will read the callsign and save you having to type
  219.      that in.
  220.  
  221. z
  222.  
  223.  
  224.  
  225.  
  226.   3. Software
  227.  
  228.      When you use the contesting software you will  need one  or two programs
  229.      depending  upon  the  hardware  configuration.  If  you are going to use
  230.      computer control of your radio then you must first run a program (in the
  231.      drivers directory)  that corresponds  to your rig. For example, before I
  232.      use any contest program, I must first:
  233.  
  234.      run drivers/ic735
  235.  
  236.      This program handles the interface to  the  rig.  Once  this  program is
  237.      running you  do not  need to kill it after stopping the logging program.
  238.      You can leave it running in the background so that  if you  start up the
  239.      logging  program  again  later,  you  do  not  also have to start up the
  240.      driver.
  241.  
  242.      If you do not start up a driver program, the contest program will report
  243.      that there  is no  driver and will then use a default frequency and mode
  244.      which you can set  in one  of the  default files  (see below).  Also, if
  245.      there's no  driver, you  must tell the program when you change frequency
  246.      or mode on the  rig. There  is an  easy way  to do  this using  the band
  247.      stacking feature which is explained later.
  248.  
  249.      The driver  program can  be terminated  by executing  the program called
  250.      stopdriver in the drivers sub-directory.
  251.  
  252.      Once the driver is  running, you  can start  up the  appropriate logging
  253.      program, whether  it be  WPX, QRP  or whatever. All need the name of the
  254.      logging file to be used. I use, for example,
  255.  
  256.      qrp ve5va.qrp
  257.  
  258.      If you do a lot of contesting it would probably help if the name  of the
  259.      logging file contained the date and mode: e.g.
  260.  
  261.      cqww 1992-cw.cqww
  262.  
  263.      Do NOT use a name that starts with the word "log". The programs output a
  264.      formatted log to file whose name begins with "log" and it is  safest not
  265.      to use this so that the program does not destroy your log file.
  266.  
  267.      Some of  the functions  of the  logging programs  are common  to all and
  268.      others are specific to the particular program.
  269.  
  270.      3.1 General functions
  271.  
  272.      All of the programs can  be  terminated  by  typing  a  Control-D  or by
  273.      clicking the  left mouse button while pointing at the top left corner of
  274.      the window. The window does not have any gadgets on it but  you can also
  275.      make the  window go to the back of all the windows in the current screen
  276.      by clicking the left mouse button while pointing at the top right of the
  277.      window. You  can push the entire current screen to the back of all other
  278.      screens by typing right-amiga-B.
  279. z
  280.  
  281.  
  282.  
  283.  
  284.      3.1.1 Default file
  285.  
  286.      All of the logging programs read two default  files when  they start up.
  287.      These  allow  you  to  set  various options. All programs first read the
  288.      file called "global.defaults" which is  in  the  "lists"  directory (see
  289.      section 4  which describes  support files). This file can be used to set
  290.      options such as your callsign which will be  the same  for all contests.
  291.      Each  program  then  reads  a  defaults  file  which is specific to that
  292.      contest program. The name of this second file depends upon  the specific
  293.      program  being  used  and  consists  of  the  program  name  followed by
  294.      ".defaults" and the file must be  in the  same directory  as the contest
  295.      program. For  example, the WPX program looks for the file "wpx.defaults"
  296.      and the QRP program  looks for  "qrp.defaults". This  file is  used, for
  297.      example, to  initialize the  content of  one or  more of  the morse code
  298.      memories which would change depending upon the contest  exchange. If you
  299.      are not  using computer  control of  your rig  you can specify a default
  300.      frequency and mode that the rig should use. Each sample default file has
  301.      documentation of the available commands but, briefly, they are:
  302.  
  303.  
  304.      !           Comment - the line is ignored.
  305.  
  306.      c call       Set your callsign. NOTE that this is normally your standard
  307.                  callsign but if you use a special prefix, or are portable in
  308.                  a different  call area or country, then you should set this 
  309.                  to the special callsign used so that the reports have  the  
  310.                  correct callsign on them.
  311.                  This command MUST be present.
  312.  
  313.      n N         Set the number of QSOs in the in-memory log to N.
  314.                  The program defaults to 2000. Each QSO is about 80 bytes, so
  315.                  the default  requires at least 160Kb of ram for the log. If 
  316.                  you aren't going to make anywhere near 2000 QSOs you can cut
  317.                  this down  to a more reasonable number (e.g. 1000, 500 or   
  318.                  whatever - but make sure you OVERestimate).
  319.  
  320.      l N string  Set CW memory N to the string.
  321.  
  322.      m S         Set morse code speed to S wpm. S is an integer between  10  
  323.               and 50.
  324.  
  325.      p N         Set the Field Day or QRP ARCI power output multiplier to N.
  326.                  You MUST  have this set correctly for these two contests    
  327.                  because it directly affects the scoring and the report      
  328.                  outputs.
  329.  
  330.      P string     Set your output power to the string (no more than 5 chars).
  331.                  Not used in scoring the log, it is only printed on QSLs when
  332.                  I get around to writing the QSL label program.
  333.  
  334.      s F          Set the QRP ARCI power Source multiplier to F.             
  335.                  F defaults to 1 but if you use a battery you would use 1.25
  336.  
  337.      t Z         Set your local timezone to Z (see next section for format).  z
  338.  
  339.  
  340.  
  341.  
  342.      f freq Mode Set the default frequency to 'freq' and mode to 'Mode'.     
  343.                  The frequency is specified in kilohertz.   
  344.  
  345.      k N         Set keyer type to N. 0=Iambic-B, 1=Iambic-A, 2=Bug
  346.  
  347.      h N         Set QRP ARCI homebrew bonus points to N.
  348.  
  349.      b            Backup the log entries to the printer as they              
  350.                  are entered. The program always writes each QSO  to the disk
  351.                  and this command makes it write it to the printer as well.
  352.                  If you edit the log and make any changes they are written to
  353.                  the printer so that you can keep track of the changes. 
  354.                  Serious contesters should use this option as a failsafe.
  355.  
  356.      a n         Turn the audio on (n=1) or off (n=0). If the audio is off
  357.                  the program responds to dupes faster because it doesn't
  358.                  have to send three beeps to the audio device.
  359.  
  360.      q n         Set the type of QRP contest. Currently 0 is QRP-ARCI and 
  361.                  1 is MI-QRP. If MI-QRP is chosen then the power multiplier
  362.                  (p command) is forced to one.
  363.  
  364.      x N          Set the PTT delay to N*10 milliseconds ... i.e. the PTT    
  365.                  delay is specified in units of 10 milliseconds.
  366.  
  367.      It is strongly recommended that you use the printer backup  throughout a
  368.      contest so  that a  disk (or  program) failure will not lose your entire
  369.      log.
  370.  
  371.      3.1.2 The date and time
  372.  
  373.      All versions of the logging programs keep track of the date and time and
  374.      store these  in each  log entry.  They also show the current time in the
  375.      top left of the screen. Just before you start a contest you should first
  376.      ensure that  your clock  is set  to the  correct time  (local or UTC) by
  377.      synchronizing it to one of  the  time  services  such  as  WWV.  If your
  378.      computer time  is local  time and  not UTC,  then you must also tell the
  379.      computer about your local  time zone.  This can  be done  in one  of two
  380.      ways. Either  you can specify the 't' command in the default file or you
  381.      can put a setenv command in  your s:startup-sequence  file which defines
  382.      the name  TZ_CHU as  your local  time. In  either case  you specify your
  383.      local timezone as hours (and optionally minutes) west (positive) or east
  384.      (negative) of  Greenwich. The program also handles daylight savings time
  385.      conversion and this must be specified in the same 't'  command or setenv
  386.      call  if  it  is  applied  in  your area. Finally, if your timezone uses
  387.      daylight savings time, then the program also needs  to know  whether you
  388.      are in  the northern  or southern  hemisphere and you encode this bit of
  389.      information by specifying the  DST indicator  in lower  (North) or upper
  390.      (South) case. The general format of the time is:
  391.  
  392.      [-]hh[:mm][D]
  393.  
  394.      This means  that the time is specified as a number of hours which can be
  395.      preceded by an optional minus sign (for EAST) and optionally followed by z
  396.  
  397.  
  398.  
  399.  
  400.      a number  of minutes  (e.g. 3:30  for Newfoundland)  and all of this can
  401.      have an optional letter after it  to  specify  that  your  timezone uses
  402.      daylight savings time. 
  403.      The dates  of the start and end of DST are different in various parts of
  404.      the world. You indicate which  is  used  in  your  zone  by  one  of the
  405.      following letters.  If you  are in the northern hemisphere then you must
  406.      specify the letter in  lower  case,  and  if  you  are  in  the southern
  407.      hemisphere then  you must  specify it in upper case. The letters and the
  408.      dates of the start and end of DST are listed below:
  409.  
  410.      d or D:   North America. Start first Sunday in April and end last Sunday
  411.                in October.
  412.  
  413.      u  or  U:      U.K.  Start  last  Sunday in March and end last Sunday in
  414.                October (approximately! - the precise dates are set  by act of
  415.                parliament each year).
  416.  
  417.      e or  E:    Europe.  Start last  Sunday in  March and end last Sunday in
  418.                September.
  419.  
  420.      c or C:   China(!). Start 12th April and end 12th September.
  421.  
  422.      If you specify upper case for the southern hemisphere then the start and
  423.      end of DST are reversed. In all cases the start and end occur at 2am.
  424.  
  425.      The  best   thing  to   do  is   to  add   a  setenv   command  in  your
  426.      s:startup-sequence file so that you don't  have to  put it  into each of
  427.      the default  files and risk forgetting one of them. If you use any of my
  428.      other programs, such as the CBBS packet program or the CHU program, then
  429.      you won't  have to  do anything extra with them if you use setenv TZ_CHU
  430.      in your startup file because they all use the same routine to  check for
  431.      your timezone and adjust to UTC. I use the command:
  432.  
  433.      setenv TZ_CHU 6
  434.  
  435.      in my  s:startup-sequence file because I am in the Central Standard Time
  436.      zone (6  hours west  of Greenwich)  and we  do not  use daylight savings
  437.      time (to  be pedantically precise, we are actually on permanent Mountain
  438.      Daylight Savings Time but very few people understand  the difference, or
  439.      care!). In  Germany, which  is one  hour ahead  of UTC and uses European
  440.      daylight savings time you would use:
  441.  
  442.      setenv TZ_CHU -1e
  443.  
  444.      I am not sure what DST is used in Australia or New Zealand but if, as an
  445.      example, they  use the  same DST  as the U.K. (except that they start in
  446.      October and end in March) then an upper case 'U' is specified along with
  447.      the timezone correction. 
  448.  
  449.      (The odd name "TZ_CHU" is derived from a program I wrote which reads the
  450.      time from Canadian radio station CHU  and sets  the amiga  battery clock
  451.      fairly precisely).
  452.  
  453. z
  454.  
  455.  
  456.  
  457.  
  458.      3.1.3 QSO entry
  459.  
  460.      All of  the programs  enter a  QSO on  the bottom line of the screen and
  461.      when it is complete, move it  up one  line. Above  that line  is a title
  462.      which  shows  the  name  of  each  field.  The  fields  whose  title  is
  463.      highlighted are the only fields that  you need  to enter  data into. The
  464.      others  will  be  filled  in  by  the  computer. For example, in the WPX
  465.      contest the title starts with the  callsign,  rst  and  QSO  number. The
  466.      callsign and  QSO number  are highlighted  but the rst is not. Thus, you
  467.      enter a callsign and QSO number, but the computer will  fill in  the rst
  468.      for you when you type a carriage return to complete the QSO information.
  469.  
  470.      Some  of  the  contest  programs  require  that  you type a space or tab
  471.      between each field (they ALL require a tab or space after the callsign).
  472.      However, there  are some exceptions. The SS program does not require any
  473.      tabs between the fields of the exchange because  it can  determine where
  474.      one ends  and another  begins so  you can type the entire SS exchange in
  475.      without typing a tab or space. 
  476.  
  477.      Some of the programs will fill in information for you  if they  can. For
  478.      example, CQWW will fill in the CQ zone of the callsign just typed if the
  479.      country is entirely contained within one CQ zone.  For example, entering
  480.      any G  call will cause CQWW to fill in 14 for the CQ zone. I have set up
  481.      the dxcc.list file so that it also splits some of the Canadian callsigns
  482.      into their  call areas  and CQWW  will fill  in those  zones that can be
  483.      identified from their prefix.
  484.  
  485.      The SS program will fill in  some dummy  information for  an exchange if
  486.      you enter a DX call.
  487.  
  488.      The ARLX  program will accept just the letter 'K' if a DX stations sends
  489.      you "KW" as their exchange. The program will change the 'K' to  'KW' for
  490.      you.
  491.    
  492.      As you type in data on the QSO line you can use: 
  493.  
  494.      - the backspace key to delete the previous character
  495.      - the delete  key to  delete the  current field. If the cursor is at the
  496.           beginning of a field, then move  to the  beginning of  the previous
  497.           field.
  498.      - the cursor  left key  moves the  cursor one  place to the left without
  499.           deleting the character. Typing the cursor  left key  with the shift
  500.           key  down  makes  the  cursor  move  back to a question mark in the
  501.           callsign field if there is one,  or  to  the  first  field  that is
  502.           blank.
  503.      - the cursor  right key  moves the cursor non-destructively one place to
  504.           the right. 
  505.      - a space or tab key causes the cursor to move to the next field  to the
  506.           right. If  the field just entered was the callsign then the call is
  507.           duped and the program will flash  the screen  and cause  an audible
  508.           beep (if  audio is  on) for  a dupe  (in which  case you can either
  509.           delete the call and start again, or enter  the QSO  anyway). If the
  510.           cursor is  at the  beginning of  a field  and nothing  has yet been
  511.           entered then the cursor will remain where it is. But  if the cursor z
  512.  
  513.  
  514.  
  515.  
  516.           is at  the beginning of a field that already contains data then the
  517.           cursor will  skip to  the next  field without  changing the current
  518.           one.
  519.      - a carriage  return key  is only valid at the end of the last field and
  520.           then the line is entered, but ONLY if there is no question  mark in
  521.           the callsign  field. This  is the  ONLY way to get a QSO entered in
  522.           the log.
  523.      - typing the Alt key and carriage return makes the cursor go to  the end
  524.           of the  entry line but does not enter it (you must hit CR again for
  525.           that).
  526.      - the escape key makes the cursor  move  to  the  right  until  it finds
  527.           either a  field whose  first character  is blank  or the end of the
  528.           data entry line, and then the  cursor  stops.  This  is  useful for
  529.           skipping over  previously entered  fields, or fields that have been
  530.           automatically filled in by the computer.
  531.  
  532.      The first field on the line is always the callsign of the  station being
  533.      worked. When  you hit a space or tab key, the callsign is checked and if
  534.      it is a dupe under the contest rules, then the screen will flash and the
  535.      audio output  will beep.  The program  will also display the highlighted
  536.      string "*DUPE*" above and to the right of the callsign - typing  any key
  537.      makes this  disappear. If  you have a dupe, you can enter the delete key
  538.      to remove the callsign or you can continue  with the  exchange and enter
  539.      the QSO anyway. Dupes are indicated in the log by putting "?DUPE" in the
  540.      score field. But, in  any case,  the QSO  will score  zero and  will not
  541.      generate any  multipliers. If  you do  not hear a complete call, you can
  542.      enter a question mark (e.g. NJ7?)  and then  enter the  remainder of the
  543.      QSO. You  can then  easily return to the callsign to fill in the missing
  544.      piece by typing the shift and cursor left keys. Then type escape  to get
  545.      to the end of the field, followed by carriage return to enter the QSO.
  546.  
  547.      If you  enter an  invalid callsign  then the  display will flash and the
  548.      message "INVALID CALLSIGN" will appear  above  the  title  line.  If the
  549.      call is  valid but the program cannot locate the callsign in the country
  550.      list, or it cannot find a valid prefix in WPX, the program will beep and
  551.      the multiplier  field will  have question  marks entered into it. If you
  552.      entered the call incorrectly then edit  the call  and try  again. But if
  553.      you are  sure you  have the call entered correctly then you should enter
  554.      the QSO anyway and proceed with the contest, although this contact won't
  555.      be scored  at this  time. The error will be caused by a problem with the
  556.      dxcc.list. Either during the contest (if you have  time) or  after it is
  557.      over, you  can examine  the callsign  and the  dxcc.list to  see why the
  558.      program could  not recognize  the call.  Then correct  the error, either
  559.      using  the  editing  function  in  the  logging  program  to correct the
  560.      callsign, or with a text editor to correct the dxcc.list and then simply
  561.      start  up  the  logging  program  again  with the log as input. When the
  562.      logging program is started, it always re-scores and re-dupes the current
  563.      log file  so that  once you  have corrected an error the logging program
  564.      will  correct  the  score  and  remove  the  question   marks  from  the
  565.      multiplier field.  You can then proceed to generate the required reports
  566.      using the %R command.
  567.  
  568.      Some numeric fields in  the contest  will allow  you to  type in  a cut-
  569.      number instead  of a  numeral. The RST field and the serial number field z
  570.  
  571.  
  572.  
  573.  
  574.      in WPX and other contests allow you to do this. This is useful on  CW so
  575.      that you  can type  exactly what you hear (if you wish). For example, in
  576.      WPX you may get a serial  number transmitted  to you  as "aont".  If you
  577.      type this in, the program will correctly translate it into 1090.
  578.  
  579.      The serial  number field in WPX, the Nr/Power field in QRP-ARCI and some
  580.      other fields will also be right  adjusted after  entry. For  example, if
  581.      you receive  the serial  number "45" in WPX, it will be left adjusted in
  582.      the serial number field when you type it, but when you enter  the QSO by
  583.      typing carriage return, the field will be right adjusted. 
  584.  
  585.      3.1.4 Frequency and mode
  586.  
  587.      If you  are using  computer controlled  frequency and  mode then you can
  588.      change the rig's frequency  and mode  by using  the mouse.  Pointing the
  589.      mouse  at  the  mode  display  and  clicking  the left button causes the
  590.      computer to change the rig's mode to the  next in  its list  which is in
  591.      the order LSB, USB, AM, CW, RTTY (if the rig has it) and FM. 
  592.  
  593.      Pointing at any digit of the frequency display and holding down the left
  594.      mouse button will cause  that digit  to be  incremented at  a rate  of 7
  595.      times per  second until  you let  go of the button. If you hold down the
  596.      right mouse button then  the  digit  will  be  decremented  7  times per
  597.      second.  In  either  case  the  rig's  frequency will be updated as this
  598.      occurs. The Yaesu protocol is rather  slow and  so this  function is not
  599.      too impressive on the FT767, but on an ICOM IC-735 it works much better.
  600.  
  601.      If  you  are  not  using  computer  control  of  a  rig (i.e. there's no
  602.      background driver) then the program initially displays the frequency and
  603.      mode that  are set in the default file and these can also be modified by
  604.      using the mouse buttons.
  605.  
  606.      3.1.5 Morse code display
  607.  
  608.      If the rig is in CW mode, the  morse code  speed is  displayed below the
  609.      list of the memory contents and you can change the speed of the keyer by
  610.      pointing the mouse at either of the digits and clicking  either the left
  611.      or right  mouse buttons. Each click of the left mouse button adds one to
  612.      the digit and each click of  the right  mouse button  subtracts one. The
  613.      keying speed is limited to between 10 and 50 WPM. 
  614.  
  615.      Beside the  CW speed  is the name of the type of keyer which will be one
  616.      of Iambic A, Iambic B or  Bug. Clicking  the left  mouse button  on this
  617.      field will cause the program to change to the next type in the sequence.
  618.      The keyer type can be set in the default file.
  619.  
  620.      The line underneath the CW speed shows the value set for PTT delay. This
  621.      number is in units of 10 ms. Setting it to zero turns PTT off.
  622.  
  623.      Each of  the 10  CW memories is associated with one of the corresponding
  624.      Function keys - thus, memory 1  is associated  with F1.  Typing just the
  625.      function key  causes that  memory to be transmitted in morse code out of
  626.      Pin 20 (DTR) on the RS-232 plug. The content of a memory  can be changed
  627.      by holding down the shift key and then typing the corresponding function z
  628.  
  629.  
  630.  
  631.  
  632.      key. The cursor will move to the selected memory and  you can  then type
  633.      in what  you want.  Type a  carriage return to finish typing the string.
  634.      The display  only shows  the first  15 or  so characters  of each memory
  635.      string, but each memory string can be up to 80 characters long.
  636.  
  637.      There are some abbreviations which you can use when entering data into a
  638.      memory.
  639.  
  640.      %c is replaced by the callsign  that is  currently stored  on the bottom
  641.           line of the display even if it is incomplete (e.g. NJ7?)
  642.      %C is replaced by your callsign which is specified in the default file.
  643.      %N is  replaced by  the current QSO number. A limited form of cut number
  644.           is employed. Leading zeroes are sent as the letter 'T'. Embedded or
  645.           trailing zeroes  are sent  as the  letter 'O'  and the  number 9 is
  646.           always sent as 'N'.
  647.      %n is the same as %N except that leading zeroes  are sent  as the letter
  648.           'T' but no other cut-numbers are used.
  649.      %R is replaced by the transmitted RST field.
  650.  
  651.      At  the  moment  none  of  the  memories  has  a specific meaning to the
  652.      program. However, I intend to make memory 10 a "CQ" memory such  that if
  653.      you type  the control key and F10 then the content of the memory will be
  654.      transmitted followed by a delay of  about 5  seconds and  if you  do not
  655.      type any key or touch the CW paddle, then the memory will be transmitted
  656.      again to a maximum of 20 times.
  657.  
  658.      At a  future date  I also  hope to  change the  program so  that you can
  659.      specify a  separate speed  for each  memory and  also a way to chain the
  660.      memories together.
  661.  
  662.  
  663.      3.1.6 Band stacking
  664.  
  665.      Holding down the shift key while pressing one of the  up, down,  left or
  666.      right arrows on the NUMERIC PAD (not the cursor control keys) causes one
  667.      of the band stacking  functions. Shift-8  causes the  current frequency,
  668.      mode  and  content  of  the  callsign  field to be stored in an internal
  669.      stack. Pressing shift-4 or  shift-6 causes  the program  to move through
  670.      the stack  returning the content of the stack to the operational fields.
  671.      If a computer controlled rig is used its current frequency and mode will
  672.      be  set  to  the  current  stacked  value.  The stack will hold up to 50
  673.      entries. This feature is  useful when  you hear  a station  that is very
  674.      busy and you decide not to wait to bust the pileup. Type in the callsign
  675.      of the station and then hit shift-8 to remember the  station's callsign,
  676.      frequency and  mode. Once  a stack  entry has  been recalled,  it can be
  677.      deleted from the stack by typing shift-2. This  feature works  even if a
  678.      computer controlled  rig is  not present  and allows you to store common
  679.      frequency/mode pairs (the callsign can be blank) in the stack. Switching
  680.      to another frequency or mode is easy using this feature. 
  681.  
  682.      The  program  stores  the  current  content  of  the  stack  in the file
  683.      "stack.dat" and if this file is present when the program  is started, it
  684.      is used  to initialize  the content  of the  stack. If you do not have a
  685.      computer controlled rig  you  can  initialize  the  stack  to  contain a z
  686.  
  687.  
  688.  
  689.  
  690.      frequency/mode pair for each band and then use the left and right arrows
  691.      on the numeric pad to select the appropriate freq/mode.
  692.  
  693.  
  694.  
  695.      3.1.7 Special Functions
  696.  
  697.      If the callsign field on the bottom line of the  screen begins  with the
  698.      '%' symbol,  then the  remainder of the line is interpreted as a command
  699.      to  the  logging  program.  These  commands  perform  such  functions as
  700.      generating reports and editing the log.
  701.      Each function  can be  called in  one of two ways. Either you can type a
  702.      command of the form:
  703.      %C <arg>
  704.      where C is a single character  and <arg>  is an  optional argument. This
  705.      command is typed in place of a callsign.
  706.  
  707.      Alternatively, the commands can be called with a control key combination
  708.      consisting of the control key and the command  letter. In  this case you
  709.      cannot specify  an argument. As an example, to do an all-band report you
  710.      can either type the command:
  711.  
  712.      %R
  713.  
  714.      in place of a  callsign,  or  you  can  just  type  the  key combination
  715.      control R (i.e. type the "r" key while holding down the control key).
  716.  
  717.      3.1.7.1 %R Generating Reports
  718.  
  719.      The command:
  720.  
  721.      %R
  722.  
  723.      produces an  all-band summary report, logs for each band and dupe sheets
  724.      for each band.  Some  contests,  such  as  Sweepstakes,  do  not require
  725.      separate band reports, in which case the program simply produces one log
  726.      and dupe file. 
  727.  
  728.      If you want to create a single band entry then specify the band with the
  729.      %R command:
  730.  
  731.      %R 15
  732.  
  733.      Will produce  single band  entry reports for the 15 meter band. The file
  734.      name of the summary report (which should always be printed) has the form
  735.      report_MM.PGM where MM is the mode ('cw','sb' or if all-mode then 'all')
  736.      and PGM is the name of the logging program ('qrp',  'wpx' etc).  The log
  737.      file names are of the form MM_BB.PGM where MM is the mode (cw or sb) and
  738.      BB is the band (either the numeric band for a single band entry or 'all'
  739.      for an  all-band entry).  Similarly, the  dupe file  names have the form
  740.      dupe_MMBB.PGM. All the files are produced  in the  current directory and
  741.      are spaced  ready for  printing (you  can use  the print  command in the
  742.      df0:c directory). 
  743. z
  744.  
  745.  
  746.  
  747.  
  748.      The QRP contest also allows hi-band and lo-band entries and  reports for
  749.      these entries can be generated with "%R H" or "%R L".
  750.  
  751.      At the  moment the  contest reports are generated in a form suitable for
  752.      printing. I hope to add the ability to output reports  in a  format such
  753.      that, if  you have  CROSSDOS(tm) or  the public  domain program MSH, the
  754.      logging programs will generate the reports ready for  copying to  an MS-
  755.      DOS formatted disk. 
  756.  
  757.  
  758.      3.1.7.2 %E Edit the Log 
  759.  
  760.      The command:
  761.  
  762.      %E
  763.  
  764.      causes the program to enter screen editing mode. It shows QSOs in blocks
  765.      of 16 at a time on the screen and you can edit the QSOs and move forward
  766.      or backwards through the log. When the program first enters edit mode it
  767.      always shows the last block of QSOs and the cursor  will be  pointing at
  768.      the callsign  of the  last QSO  in the  log. This enables you to rapidly
  769.      edit the last QSO,  if necessary.  The four  cursor keys  in combination
  770.      with  the  shift,  control  and  alt  keys  can  be  used to perform the
  771.      following functions:
  772.  
  773.      - Cursor up
  774.           Moves the cursor up to the previous QSO, maintaining its  current X
  775.           coordinate on  the screen.  If the  cursor is on the top QSO on the
  776.           screen then the previous block of 16 QSOs will be  displayed unless
  777.           the program  is displaying  the first  16 QSOs in the log, in which
  778.           case nothing will happen.
  779.  
  780.      - Alt Cursor up
  781.           Moves cursor back to a previous QSO which  contains '?' (indicating
  782.           a questionable callsign or a DUPE).
  783.  
  784.      - Shift cursor up
  785.           Move back one QSO block if there is one.
  786.  
  787.      - Control cursor up 
  788.           Displays the first block and moves the cursor to the first QSO.
  789.  
  790.      - Cursor down
  791.           Similar to  cursor up  functions. Moves cursor down one line on the
  792.           screen if not at the last QSO in the log.  If at  the last  line on
  793.           the screen then show the next block if there is one.
  794.  
  795.      - Alt cursor down
  796.           Move cursor down to next QSO containing '?' if there is one.
  797.  
  798.      - Shift cursor down
  799.           Move forward one QSO block if there is one.
  800.  
  801. z
  802.  
  803.  
  804.  
  805.  
  806.      - Control cursor down 
  807.           Displays the last block and moves the cursor to the last QSO.
  808.  
  809.      - Cursor left
  810.           Move cursor  one place  left. If  at the  beginning of the line, do
  811.           nothing.
  812.      - Shift cursor left
  813.           Move cursor to beginning of current line.
  814.  
  815.  
  816.      - Cursor right
  817.           Move cursor one place right. If at the end of line, do nothing.
  818.  
  819.  
  820.      - Shift cursor right
  821.           Move cursor to end of current line.
  822.  
  823.  
  824.      The backspace key deletes the character to its left (i.e.  changes it to
  825.      a space).
  826.  
  827.      Typing alphanumeric  characters or  the characters '/' or '.' or a space
  828.      types those characters  over  the  top  of  what  was  there  -  i.e. it
  829.      replaces them in the log.
  830.  
  831.      When you  edit a  log entry  it can  change the score. You can change as
  832.      many QSOs in the  log as  you wish  but when  you terminate  the editing
  833.      session the program rescores the whole log.  
  834.    
  835.      Typing  Control-D  terminates  the  editing  function and returns you to
  836.      logging mode (after rescoring the log if any changes have been made).
  837.  
  838.      If you edit any QSO, then when you terminate the  program, it  will also
  839.      do a backup function (see next section).
  840.  
  841.      3.1.7.3 %B Backup the memory log
  842.  
  843.      If  no  filename  follows  the  %B  command then the current disk log is
  844.      copied to the file:
  845.  
  846.      /backup/backup.PPP
  847.  
  848.      where PPP is the abbreviation for the contest program you are using such
  849.      as wpx  or wrp.  Then it writes the in-memory log into the original disk
  850.      log. Note that this  requires  that  the  directory  called  "backup" is
  851.      present as  it is  provided on  the distribution disk. If you cannot put
  852.      the backup directory on the same  disk as  the contest  programs then an
  853.      environment variable   LOGBACKUP  must be  defined before the program is
  854.      started. It is best to put a setenv  command in  your s:startup-sequence
  855.      file so  that it is defined every time you reboot your system. It can be
  856.      defined to be in ram: (not very wise though!), or a directory  on a hard
  857.      or floppy disk (much wiser).
  858.  
  859. z
  860.  
  861.  
  862.  
  863.  
  864.      If you specify a filename e.g. "%B work:log.backup" then the disk log is
  865.      copied to that file before the memory log is copied to the  current disk
  866.      log. 
  867.  
  868.      The program  does an  automatic backup when you terminate the program if
  869.      you have edited any QSOs at all.
  870.  
  871.      3.1.7.4 %F Changing the Frequency and mode
  872.  
  873.      When the computer is not being used with a computer controlled radio the
  874.      displayed frequency and mode can be changed using the mouse or the stack
  875.      as previously described. You can also use a command of the form:
  876.  
  877.           %F FREQ MODE
  878.      This command changes the  displayed  frequency  to  FREQ  which  must be
  879.      specified in  kilohertz and  must not  contain commas.  The MODE must be
  880.      present and is one of: 
  881.  
  882.           cw lsb usb am fm rtty 
  883.    
  884.  
  885.  
  886.      3.1.7.5 %S Score the log
  887.  
  888.      The command %S causes  the program  to rescore  the log  and display any
  889.      changes that result. You should normally not need to do this since a new
  890.      QSO is scored upon entry and if you edit the log it is also  rescored if
  891.      necessary when the edit function is terminated.
  892.  
  893.      3.1.7.6 %X Screen dump
  894.  
  895.      The command  %X creates  a file  of the form screen.PPP where PPP is the
  896.      name of the program (e.g.  wpx)  and  the  file  will  contain  an ASCII
  897.      representation of  what is  on the  screen at the time the %S command is
  898.      given. This is more a debugging command than a feature.
  899.  
  900.  
  901.  
  902.      3.2 AREXX Support (PacketCluster)
  903.  
  904.      I have added an AREXX port to the contest programs  and included  on the
  905.      distribution   disk    the   public    domain   AREXX   library   called
  906.      rexxhost.library. All contest programs start  up  the  AREXX  port named
  907.      VE5VA_LOGGER  so  that  they  will  be  able  to  send and receive AREXX
  908.      commands. In order to use the AREXX functions  you must  have a  copy of
  909.      rexxhost.library  in  your  LIBS:  directory.  If  you do not have AREXX
  910.      running, or do not have a  copy of  rexxhost.library, it  doesn't matter
  911.      because the programs will ignore it if it isn't there. At the moment the
  912.      AREXX port is used to do a simple demonstration of PacketCluster support
  913.      which  will  be  expanded  in  the  future  to  give full support from a
  914.      separate program (like  the  computer  interface  drivers).  The trivial
  915.      AREXX  program  test.lgx  shows  how  to send DX messages to the contest
  916.      program.
  917. z
  918.  
  919.  
  920.  
  921.  
  922.      When a DX spot arrives, the program first dupes it. If it is a dupe then
  923.      the DX  spot message  is ignored.  If it  is not a dupe then the program
  924.      displays the new DX info in the bottom right of the screen at the top of
  925.      a list  of DX  spots. As new ones are added the old ones are pushed down
  926.      so that the one displayed at the top of the list is the most recent one.
  927.      The program  displays the  most recent five DX spots it has received but
  928.      internally it actually stores up to 50. 
  929.      You do not have to respond immediately to  an incoming  DX spot.  If you
  930.      are busy  the spot  can be left on the DX queue as long as you don't let
  931.      the queue get too big. However, there are  three control  characters you
  932.      can type which affect the DX spots. Typing ^K deletes the DX spot at the
  933.      top of the list. Typing ^P  pushes the  top DX  spot onto  the stack and
  934.      then deletes  it from the list. Typing ^G means "Go there right now" and
  935.      the program will change to the frequency of  the DX  spot and  will also
  936.      copy the  callsign into the data entry area at the bottom of the screen.
  937.      You can type ^K or ^P  while you  are entering  a callsign  or other QSO
  938.      data.
  939.    
  940.      Although not  useful yet, the programs can also send AREXX messages. The
  941.      @ command typed in the callsign  field specifies  an AREXX  port address
  942.      (similar to the AREXX ADDRESS command) and then a string following the &
  943.      command is sent to that port. For example:
  944.  
  945.      @FANCYDEMO
  946.      &HELLO THERE - THIS IS A TEST
  947.      will send the string "HELLO THERE - THIS  IS A  TEST" to  the AREXX port
  948.      whose name  is "FANCYDEMO".  At the  moment the  program only uses upper
  949.      case and therefore it can't be used to send to ports whose AREXX address
  950.      contains lowercase  or which expects lowercase commands. This ability to
  951.      send to an AREXX  port will  be used  to allow  the operator  to send DX
  952.      spots to a PacketCluster. 
  953.  
  954.      The addition  of the  AREXX port  will allow  other programmers to write
  955.      separate programs which can interface to  the logger  programs. The only
  956.      thing we  would need to cooperate on is the structure and content of the
  957.      AREXX commands and all details of the internal workings of  the programs
  958.      will be irrelevant.  z
  959.  
  960.  
  961.  
  962.  
  963.   4. Support Files
  964.  
  965.      All of  the contest  programs use  some auxiliary files. For contests in
  966.      which a DXCC country is a  multiplier, the  file dxcc.list  is used. The
  967.      CQWW program  uses both the dxcc.list and the file called wae.list which
  968.      contains a list of countries that  are in  the WAE  list but  not in the
  969.      DXCC list  (e.g. Sicily).  The FD  and SS programs use files to describe
  970.      the ARRL sections.
  971.  
  972.      All of these  files  must  reside  in  the  same  directory  and  on the
  973.      distribution disk  they are in the directory called "lists". If you keep
  974.      this structure then you do not need to do anything to tell  logger where
  975.      to find  this directory.  If, for  some reason,  you must move the lists
  976.      directory somewhere else  then  you  can  tell  logger  where  it  is by
  977.      defining an  environment variable called LOGLISTS. For example you could
  978.      use:
  979.  
  980.      setenv LOGLIST work:logger/lists
  981.  
  982.      in your startup sequence.
  983.  
  984.  
  985.      4.1 The DXCC files
  986.  
  987.      The  dxcc.list  and  wae.list  files  have  the  same  format  and their
  988.      structure is described in the comments at the beginning of the files. 
  989.      The CQWW program reads both the dxcc and wae files. Several of the other
  990.      programs, such as ARLX, use the dxcc file.
  991.  
  992.      It is very difficult for me to  keep  these  files  up  to  date.  It is
  993.      therefore essential  that you  ensure that  these files are correct when
  994.      using a DX contesting program. 
  995.  
  996.      Wildcards are allowed to  specify  a  range  of  matching  callsigns and
  997.      currently the wildcards are:
  998.  
  999.      # matches a string of numeric digits.
  1000.      $ matches a single numeric digit
  1001.      @ matches a string of alphabetic characters
  1002.      $ matches a single alphabetic character
  1003.      * matches an alphanumeric string only
  1004.  
  1005.      Country  prefixes  can  also  be  specified  as  a  range  when  this is
  1006.      appropriate. For  example,  Canada  is  allocated  the  entire  block of
  1007.      callsigns from  VAA through to VGZ. This can be entered in the dxcc.list
  1008.      file as VA-VG (but NOT VAA-VGZ).  Wildcards are  more efficient  if they
  1009.      can be  used because  they cause  only one  prefix entry in the internal
  1010.      country list. Thus, 4U#UN  will cause  only one  entry in  the table but
  1011.      will match  a wide  range of 4U calls. Whereas VA-VG will generate seven
  1012.      entries, one for each of VA, VB, ...., VG. 
  1013.  
  1014.      The DXCC files contain entries for  CQ  and  ITU  zones.  These  MUST be
  1015.      entered correctly and if the country being entered covers two or more of
  1016.      these zones then ALL the zones must be entered. This is because  if only z
  1017.  
  1018.  
  1019.  
  1020.  
  1021.      one zone  is entered,  then the  CQWW contest,  for example, will assume
  1022.      that the country is entirely within one zone and will automatically fill
  1023.      the zone  information into  the QSO  line during the contest. So, if the
  1024.      country (e.g. the U.S., Canada) covers more than  one zone,  these zones
  1025.      must be  entered so  that CQWW  will not  fill in  a zone  at all. It is
  1026.      possible to split up a country into callsign  areas if  this also splits
  1027.      them into  individual CQ  and/or ITU zones. For example, although Canada
  1028.      is spread across several ITU and CQ zones, the province  of Saskatchewan
  1029.      (VE5) is  entirely contained  within CQ  zone 4 and ITU zone 3. An entry
  1030.      can be made in the dxcc.list file which informs the  program of  this so
  1031.      that the  CQWW program  can fill in the zone. See the dxcc.list file for
  1032.      an example of how  this is  done. It  is more  difficult to  do the same
  1033.      thing for  U.S. calls  because their  callsign areas  do not necessarily
  1034.      reflect actual geographic location. Thus a W6 need not be in California.
  1035.      It is best to leave the U.S. entries as they are.
  1036.  
  1037.      Currently the  latitude and longitude are read in by the program but are
  1038.      not used in any way. I  plan to  add a  beam heading  calculation to the
  1039.      programs  at  some  point  so  you  should  ensure that the latitude and
  1040.      longitude entries are correct.
  1041.    
  1042.      4.2 ARRL sections (FD and SS)
  1043.  
  1044.      The ARRL sections are kept in the file  ss.list. The  format is somewhat
  1045.      different than  the country  lists since zones and lat/long are omitted.
  1046.      The first column specifies the correct abbreviation for the ARRL section
  1047.      and the  second column  specifies the full name of the section. The last
  1048.      column specifies any of the variations  that  you  might  receive  in an
  1049.      actual  contest.  You  can  type  in  what you hear and the program will
  1050.      replace it with the  correct abbreviation  when you  enter the  QSO. For
  1051.      example, if  someone sends  you the section "MISS", you can type this in
  1052.      and the program will change it to "MS" when you  enter the  QSO. On SSB,
  1053.      whenever you  hear the  words "North",  "East", "South" or "West", enter
  1054.      them as a single letter with a space  after them.  So if  you hear "EAST
  1055.      BAY" enter  it as "E BAY". It would help if you look through the ss.list
  1056.      file before a contest to familiarize yourself with what it  considers to
  1057.      be acceptable  abbreviations. You can, of course, add more abbreviations
  1058.      if you wish.
  1059.  
  1060.      One word of caution. The ARRL abbreviation for  the Los  Angeles section
  1061.      is "LAX",  whereas "LA"  is the state of Louisiana. If you type "LA" for
  1062.      the Los Angeles section, the program has  no  way  to  know  that  it is
  1063.      incorrect and  will score it as a QSO with Louisiana. On SSB, it is best
  1064.      to just enter "LOS" for a Los Angeles QSO because the ss.list  will take
  1065.      care of it and change it to LAX.
  1066.  
  1067.      4.3 QRP contest
  1068.  
  1069.      The QRP ARCI contest uses states/provinces/countries as multipliers, but
  1070.      the only file it uses at the moment  is the  dxcc.list. This  means that
  1071.      you MUST  enter the  correct state  abbreviation. I  will eventually add
  1072.      another file to this  program so  that it  will do  for states/provinces
  1073.      what the ss.list file does for ARRL sections.
  1074.      4.4 CARF contest z
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.      This contest  uses two files. The first, ve.list, contains only the dxcc
  1081.      entry for Canada. The other, carf.list,  contains a  file formatted like
  1082.      ss.list  which  allows  mapping  of  strings  into  the correct province
  1083.      abbreviation. For example, "QUEBEC"  or  "QUE"  will  be  mapped  to the
  1084.      correct "PQ".
  1085.  
  1086.      4.5 SS contest
  1087.  
  1088.      The sweepstakes  contest program  uses the ss.list as described above in
  1089.      Section 4.2, but it also uses  a file  called "w-ve.list".  This file is
  1090.      formatted like  the dxcc.list  file (in  fact it  is taken  from it) and
  1091.      contains  only  the  dxcc  entries  for  Canada,  the   U.S.A.  and  its
  1092.      possessions. This allows the SS program to detect when a DX callsign has
  1093.      been entered. It will log, but not score, a DX contact. z
  1094.  
  1095.  
  1096.  
  1097.  
  1098.   5. LOG FILE STRUCTURE
  1099.  
  1100.      No matter which contest program you use, the log file always consists of
  1101.      lines of  80 characters  each, the 80th character being the linefeed and
  1102.      the 79th character indicates which  contest  program  produced  the log.
  1103.      This allows  you to edit the log file with an editing program instead of
  1104.      using the editing function in the contest programs.  BUT be  warned that
  1105.      if you  modify a  line, it MUST still be exactly 80 characters long when
  1106.      you are done. 
  1107.  
  1108.      The codes used at the end of the line are:
  1109.  
  1110.      F    Field day      (FD)
  1111.      X    CQ WPX         (WPX)
  1112.      Q    QRP ARCI       (QRP)
  1113.      A    ARRL DX        (ARLX)
  1114.      C    CQWW DX        (CQWW)
  1115.      E    DARC WAE       (WAE)  
  1116.      S    Sweepstakes    (SS)
  1117.      T    CARF contest   (CARF)
  1118.  
  1119.      The WAE contest hasn't been written yet.
  1120.  
  1121.      If you look at the log file you will notice  that all  the fields  up to
  1122.      and including  the callsign  are always  the same  size and  in the same
  1123.      columns. What  follows  after  the  callsign  depends  upon  the contest
  1124.      exchange but  the received exchange follows the callsign. After that are
  1125.      columns which, depending upon  the contest,  show the  contest exchange,
  1126.      new multipliers  and, finally,  the score  for that QSO. If the QSO is a
  1127.      dupe, or the program could not  recognize the  callsign, then  the score
  1128.      field contains  "?DUPE" or "?ERROR". The SS program also uses ?DX if the
  1129.      QSO was a DX contact.
  1130.  
  1131.    
  1132.   6. KNOWN BUGS and SHORTCOMINGS
  1133.  
  1134.   - There is currently no way to change the transmitted QSO serial number. It
  1135.   is directly tied to the number of QSOs in the log.
  1136.  
  1137.  
  1138. z
  1139.  
  1140.  
  1141.  
  1142.  
  1143.   7. The AUTHOR
  1144.  
  1145.      I have  had chronic  fatigue syndrome  since September  of 1984 and have
  1146.      been on long term disability ever since. These  programs are  the result
  1147.      of very slowly working on them a bit at a time, when I am able, over the
  1148.      course of over two years (plus some prodding from Cyril VE5CB). There is
  1149.      no  timetable  associated  with  the enhancements mentioned in the above
  1150.      documentation. If I feel well enough to tackle  something I  will do it.
  1151.      If I don't, then it doesn't get done.
  1152.  
  1153.      I  have  made  these  programs  available  for anonymous FTP on the site
  1154.      ftp.usask.ca in the directory  pub/amiga/hamradio.  If  you  want  to be
  1155.      notified of a new release then send your Internet address to me:
  1156.      hardie@herald.usask.ca
  1157.  
  1158.      The programs  may be  freely distributed - with the accent on FREELY. NO
  1159.      CHARGE MAY BE MADE FOR DISTRIBUTING THESE PROGRAMS (other than  the cost
  1160.      of  the  disk  and  a  reasonable  charge for postage) AND NO COMMERCIAL
  1161.      DISTRIBUTION,  INCLUDING  THAT  BY  COMPANIES  WHO  SELL  COLLECTIONS OF
  1162.      PROGRAMS, IS PERMITTED. 
  1163.  
  1164.      THE SOURCE CODE WILL NOT BE MADE AVAILABLE.
  1165.  
  1166.      I RESERVE  TO MYSELF  THE RIGHT  TO SEND THESE PROGRAMS TO FRED FISH FOR
  1167.      DISTRIBUTION. DO NOT SEND THEM TO HIM.
  1168.  
  1169.      IF I FIND THAT THE ABOVE CONDITIONS  ARE  NOT  ADHERED  TO  THEN  I WILL
  1170.      EITHER STOP  DEVELOPMENT AND/OR  DISTRIBUTION ENTIRELY, OR I WILL MODIFY
  1171.      THE PROGRAMS SO THAT VARIOUS PARTS  OF THE  PROGRAM ARE  ENCODED AND YOU
  1172.      WILL ONLY BE ABLE TO GET THE UPDATES FROM ME.
  1173.  
  1174.  
  1175.  
  1176.  
  1177.      Thanks to Olaf Bartel for his completely public domain rexxhost.library.
  1178.      The complete package is on Fred Fish disk #682 c